Inside Macintosh: QuickTime /

Chapter 2 - Movie Toolbox / Movie Toolbox Reference

Functions for Getting and Playing Movies / Generating Pictures From Movies

GetMoviePict

The GetMoviePict function creates a picture from the specified movie at the specified time. This function uses only those movie tracks that are currently enabled and would therefore be used in playback. Your application may call this function even if the movie is inactive.

pascal PicHandle GetMoviePict (Movie theMovie, TimeValue time);

theMovie

Specifies the movie for this operation. Your application obtains this movie identifier from such functions as NewMovie, NewMovieFromFile, and NewMovieFromHandle (described on page 2-80, page 2-76, and page 2-78, respectively).

time

Specifies the movie image for the picture. The time parameter contains the time from which the image is taken.

DESCRIPTION

The GetMoviePict function returns a handle to the picture. Your application must dispose of this picture handle by calling QuickDraw's KillPicture routine. If the function could not create the picture, the returned handle is set to nil.

SPECIAL CONSIDERATIONS

You can use the GetMoviePict function to create a picture. If the movie contains compressed data, the picture created by this function may also contain compressed data that cannot be displayed without QuickTime.

ERROR CODES

invalidMovie	-2010	This movie is corrupted or invalid
invalidTime	-2015	This time value is invalid

Image Compression Manager errors
Memory Manager errors

SEE ALSO

If you want to create a picture from a movie's preview, put the movie into preview mode by calling the SetMoviePreviewMode function (described on page 2-107), and then call the GetMoviePict function.